home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #20 (1988)(Merlin's Software)(PD).zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #20 (1988)(Merlin's Software)(PD).adf / Doc-Files / Graphics.Doc < prev    next >
Text File  |  1988-05-30  |  14KB  |  346 lines
  1.  
  3. Graphics Docs
  5. This file includes Documentation for all files in the Graphics Drawer. They 
  6. have all been combined into one to save disk space.
  7.  
  8. The Docs included in this file are:
  10. QuickFlix
  11. MazeMan
  12. MakeAnim
  14.  
  15. Doc File Headers are in RED!
  16.  
  17.  
  18.  
  19. *****************************************************************************
  20.  
  21.  
  22.  
  24.  
  25.                            QuickFlix Rev 0.12
  26.  
  27.     Copyright (c) 1987  Jeff Kunzelman, Rodney Iwashina, Takeshi Suganuma
  29.   If you like this program please feel free to send a donation ($10.00)
  30.   payable to:
  31.           Rodney Iwashina  11333 Yolanda Ave.  Northridge, Ca. 91326
  32.  
  33.   You can make as many copies of this program as you like and give it to
  34.   all your friends, on the condition that you abide by these guidelines:
  35.  
  36.      The copy(s) (including documentation) must remain unmodified
  37.      and intact.
  38.      The copy(s) cannot be sold for money or profit, except by the
  39.      original authors.
  40.      At the time of transfer, the new recipient(s) agree(s) to the above
  41.      guidelines.
  42.  
  43.   Suggestions and comments of any kind can be sent to the above address
  44.   or through CIS (76224,102).  We hope that you enjoy this shareware!
  45.  
  46.  
  47. Introduction:
  48.  
  49.         QuickFlix is an IFF slideshow and cel animation program.
  50.         It takes full advantage of the Amiga's multi-tasking operating
  51.         system by creating multiple tasks to manage each of its
  52.         resources, communicating via executive messages and ports,
  53.         and sharing data in a common memory pool.  QuickFlix supports
  54.         the LO-RES, HI-RES, NON-INTERLACE, INTERLACE, and HAM modes of
  55.         the Amiga.  QuickFlix can be commanded to run independently
  56.         or can be triggered by an external source.  A stand-alone
  57.         slideshow or animation sequence can be gernerated when
  58.         QuickFlix is run independently.  External triggering allows a
  59.         user to interactively control the slideshow or animation.
  60.         QuickFlix implements a caching system that pre-loads pictures
  61.         into memory.  This feature allows QuickFlix to support the
  62.         rapid frame rate necessary for cel animation.
  63.  
  64.  
  65. CLI Usage:
  66.  
  67.         QuickFlix [-t<tick rate>] [-l<log file>] <script file> ...
  68.  
  69.         <script file> is the name of the script file containing the
  70.                 names of the pictures, the special effects information,
  71.                 and the timing information.  All timing information is
  72.                 expressed in number of ticks.  Multiple script files
  73.                 may be chained together by specifying them on the
  74.                 command line.
  75.  
  76.         -t<tick rate> indicates the timer tick rate, where <tick rate>
  77.                 is a decimal integer from 0 to 60, corresponding to tick
  78.                 rates of 0 to 60 ticks per second.  When the tick rate is
  79.                 set to 0, the external triggering is enabled.  This
  80.                 option defaults to 30 tick per second.
  81.  
  82.         -l<log file> designates the file to log informational and error
  83.                 messages.  If this option is not specified, no log file
  84.                 will be created.
  85.  
  86.         QuickFlix can be exited at any time by pressing the ESC key or
  87.                 <CTRL> C; holding the CTRL key down and pressing the C key.
  88.  
  89.         usage example:
  90.  
  91.                 QuickFlix -t24 -llogfile script
  92.  
  93.                 This example will read the script information from the
  94.                 file "script", the tick rate will be 24 ticks per
  95.                 second, and the log information will be written into the
  96.                 file "logfile".
  97.  
  98.  
  99. Workbench Usage:
  100.  
  101.         QuickFlix can also be invoked from the Workbench.  A single
  102.         script can be invoked by double-clicking on the desired script
  103.         file icon.  A single script file can also be invoked by
  104.         shift-clicking (holding the SHIFT key down and clicking on the
  105.         the icon) the desired script file icon, then double-clicking
  106.         on the QuickFlix icon.  Multiple scripts can be invoked by
  107.         shift-clicking all desired script file icons, then double-clicking
  108.         on the QuickFlix icon.  When multiple scripts are selected, the
  109.         'tool types' information from the first shift-selected script
  110.         will be used for all subsequent scripts.
  111.  
  112.         Valid Tool Types:
  113.  
  114.              n=<anything> (no seperate fast memory cache)
  115.              l=<log file name>
  116.              t=<ticks per second> (t=0 = use joystick)
  117.  
  118.              All others will be ignored.
  119.  
  120.  
  121. Script Format:
  122.  
  123.         Entries in the script file must conform to the following format:
  124.  
  125.         s <picture file> - any IFF picture file
  126.  
  127.         n <ticks> - Switch to next picture in script in <ticks> ticks
  128.                 where <ticks> is a positive decimal integer.  If
  129.                 the last picture in the script includes this entry,
  130.                 QuickFlix will exit when the switch occurs, otherwise
  131.                 the last picture will remain on the screen until QuickFlix
  132.                 is manually exited via an ESC or <CTRL> C.
  133.  
  134.         i <start ticks> <end ticks> <interval ticks> <red> <green> <blue> -
  135.                 Fade in the current picture starting at <start ticks> ticks
  136.                 after the picture is switched in, end fade at <end ticks>
  137.                 ticks after the picture is switched in, fade at intervals
  138.                 of <interval ticks> ticks, and fade in from color <red>,
  139.                 <green>, <blue> where all tick values are positive decimal
  140.                 integers and all colors are hexidecimal values from 0 to f.
  141.  
  142.         o <start ticks> <end ticks> <interval ticks> <red> <green> <blue> -
  143.                 Fade out the current picture starting at <start ticks> ticks
  144.                 after the picture is switched in, end fade at <end ticks>
  145.                 ticks after the picture is switched in, fade at intervals
  146.                 of <interval ticks> ticks, and fade out to color <red>,
  147.                 <green>, <blue> where all tick values are positive decimal
  148.                 integers and all colors are hexidecimal values from 0 to f.
  149.  
  150.         c <start ticks> <end ticks> <delay factor> - Cycle color ranges
  151.                 starting at <start ticks> ticks after the picture is
  152.                 switched in, end cycling at <end ticks> ticks after the
  153.                 picture is swithced in, with a delay factor of
  154.                 <delay factor> applied to the color cycle rate where
  155.                 all values are positive decimal integers.  The color
  156.                 cycle ranges and rates are read from the IFF file.
  157.  
  158.         script example:
  159.  
  160.                 s picture1
  161.                 n 40
  162.                 i 0 0 1 0 0 0
  163.                 o 20 0 1 f f f
  164.                 s picture2
  165.                 n 60
  166.                 i 0 0 2 f f f
  167.                 o 30 0 2 0 0 0
  168.                 s picture3
  169.                 n 80
  170.                 i 0 0 1 0 0 f
  171.                 o 60 0 1 0 0 f
  172.                 c 0 0 1
  173.  
  174.                 This example will show three pictures.  The first picture
  175.                 is "picture1".  It will be shown for 40 ticks, fade in from
  176.                 black when it is switched in, and fade out to white 20
  177.                 ticks from the time it is switched in.  The second picture
  178.                 is "picture2".  I will be shwon for 60 ticks, fade in from
  179.                 white when it is switched in, and fade out to black 30
  180.                 ticks from the time it is switched in.  The third picture
  181.                 is "picture3".  It will be shown for 80 ticks, fade in
  182.                 from blue when the picture is switched in, fade out to blue
  183.                 60 ticks from the time it is switched in, and will color
  184.                 cycle the cycle ranges with a delay factor of 1.  QuickFlix
  185.                 will exit after showing this picture since it is the last
  186.                 one in the script and it specifies a switch.
  187.  
  188.  
  189. Cel Animation:
  190.  
  191.         Given the architecture of the system, cel animation becomes
  192.         a simple exercise of script manipulation.  The pictures that
  193.         make up the animation can be entered to be shown for a short
  194.         nubmer of ticks, and the tick rate can be adjusted to a reasonable
  195.         rate for animation.  The cache allows rapid switching of pictures
  196.         as long as the pictures are in the cache, otherwise the pictures
  197.         have to be read from the disk.  The cache will hold about 5
  198.         320x200x5 (typical DeluxePaint) pictures on a 512K Amiga, about
  199.         40 on a 2.5M Amiga.  These numbers will vary depending on the
  200.         resolution, interlace, and number of bit planes, because the cache
  201.         is memory dependent.  The more memory, the better, but if the
  202.         display rate exceeds the cache fill rate, the cache will
  203.         eventually get behind, causing a pause in the animation.  There
  204.         are a number of things you can do to optimize animations.
  205.         Additional memory will result in a larger cache and therefore
  206.         a higher cache hit rate.  A hard disk will increase the transfer
  207.         rate of pictures from disk to cache.  Pictures with fewer bit
  208.         planes will decrease the amount of memory needed for each picture.
  209.         Repeating short sequences of pictures in the script will allow
  210.         a higher cache hit rate.  Color cycling can be used to simulate
  211.         animation.
  212.  
  213.  
  214. External Triggering:
  215.  
  216.         External triggering allows a user to interactively control the
  217.         slideshow or animation.
  218.  
  219.         A joystick connected to port 2 of the Amiga can be used for
  220.         interactive control.  The joystick can increase or decrease
  221.         the tick rate by pushing the joystick up or pulling it back.
  222.         Pressing the joystick button at any time will enable the
  223.         single-step mode.  In this mode, each button press will cause
  224.         a timer tick to occur.  Continuous timer tick mode is re-enabled
  225.         by moving the joystick up or down.  Moving the joystick to the
  226.         right will switch to the next picture in the script.
  227.  
  228.  
  229. Known Problems:
  230.  
  231.         The picture swithing rate does not keep up with the tick rate
  232.         at tick rates exceeding about 24 frames per second.
  233.  
  234.         Fades and color cycling effects do not work on HAM pictures.
  235.  
  236.  
  237. Future Enhancements:
  238.  
  239.         We are continuously trying to improve our product.  Suggestions
  240.         and comments are more than welcome.  We would like to know what
  241.         type of application you are using QuickFlix for and any
  242.         enhancements that you would like to see incorporated into it.
  243.         Our current list of enhancements follow.
  244.  
  245.                 Repeat and reverse for script
  246.  
  247.                 External device synchronization
  248.  
  249.                 Additional special effects
  250.  
  251.  
  252. Notes:
  253.  
  254.        The logfile output option is extremly handy to determine
  255.        problems.  The logfile will keep a trace of the general
  256.        operation of the QuickFlix system.  Information will include
  257.        cache statistics and errors.  The errors will indicate
  258.        bad IFF files, memory resource problems, etc.  A good place
  259.        to put the logfile is in the ram disk (i.e. -l ram:logfile).
  260.        The log file will not be created with an icon so it must be
  261.        accessed from the CLI.
  262.  
  263.        We really are looking for comments about this program, so
  264.        drop us a note and tell us what you think.
  265.  
  266. *****************************************************************************
  267.  
  268.  
  269.  
  271.  
  272.       MAZEMAN by John James
  274.       Amiga Friends member #046
  275.  
  276.       Downloaded from 77AMIGA   (714) 772-6442 Amiga only BBS.
  277.                                 with 62meg hard drive space!!!
  278.  
  279.       The Amiga is now a real computer.....  YES! at last PACK MAN!!!
  280.  
  281.       For more information about Amiga Friends or 77AMIGA call Voice
  282.               
  283.                               (714) 635-2100
  284.  
  285. *****************************************************************************
  286.  
  287.  
  288.  
  290. MAKEANIM
  292.     Hi.
  293.  
  294.     Here's an ANIM standard compressor, which can take a series of IFF
  295.     files and combine them into a single animation file that can be
  296.     played back with ShowANIM, as well as the Director and Aegis
  297.     VideoSeg.  To create a compressed ANIM file, construct a text
  298.     file with a list of file names of frames to be assembled, one
  299.     per line:
  300.  
  301.     pictures/frame01
  302.     pictures/frame02
  303.     pictures/frame03
  304.     pictures/frame04
  305.     pictures/frame05
  306.     pictures/frame01
  307.     pictures/frame02
  308.  
  309.     Files can reside on different disks, just enter the entire path 
  310.     name (including disk name).  A requester will pop up when it's time
  311.     to put in the appropriate disk.
  312.  
  313.     If you want to create an endless loop, make sure the first two
  314.     frames are repeated at the end of the file as in the example above.
  315.  
  316.     Once the list file is created (let's call it FLIST) you then
  317.     issue the command:
  318.  
  319.     MakeANIM FLIST test.anim
  320.  
  321.     This will read the frames in one by one and create the ANIM file
  322.     with the name "test.anim".  This file can then be played back with
  323.     the abovementioned player programs.
  324.  
  325.     The program should work in any resolution including HAM, but don't
  326.     try to mix resolutions.  The color palettes should all be the same,
  327.     as this version does not handle palette changing on the fly.
  328.  
  329.     This program has been successfully used to construct standard format
  330.     ANIM files from Animate3D frames, as well as individual files created
  331.     by paint programs.
  332.  
  333.     How much memory do you need?  Good question.  The program will
  334.     create 4 buffers the size of the IFF image during compression.
  335.     Only one buffer is required to be in CHIP memory.  Lo-res shouldn't
  336.     be any trouble for anybody, but I don't know exactly where the dividing
  337.     lines are otherwise.
  338.  
  339.  
  340.  
  341. *****************************************************************************
  342.  
  343.  
  344.  
  345.  
  346.